﻿<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office">

<head>
<meta http-equiv="Content-Language" content="en-us" />
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Need OCD?</title>
<style type="text/css">
.Header1 {
				margin: 0px 0 0 0;
				font-size: xx-large;
				font-weight: bold;
				text-align: left;
				line-height: normal;
				background-color: #E0E0E0;
}
.Header2 {
				font-size: xx-large;
				font-weight: bold;
				margin: 0px;
				line-height: 100%;
}
.Header3 {
				font-size: x-large;
				font-weight: bold;
				text-align: left;
				line-height: 100%;
				margin: 0px;
}
.note {
				font-family: Arial, Helvetica, sans-serif;
				font-weight: bold;
				margin-left: 40px;
}
.description { font-size: 1.2em; margin-bottom: 30px; margin-top: 30px; font-style: italic;}
.download { float: right; }
.inline_code {
				font-family: "Courier New", Courier, monospace;
				font-size: small;
}
.cmd_line {
				background: #000;
				color: #fff;
				padding: 10px;
				font-family: "Courier New", Courier, monospace;
				font-size: small;
}
.code_block {
				margin-left: 40px;
				font-family: "Courier New", Courier, monospace;
				font-size: small;
}
.filename {
				font-family: Arial, Helvetica, sans-serif;
				font-size: small;
}
.Code_Header {
				font-size: xx-large;
				font-weight: bold;
				text-align: left;
				font-family: "Courier New", Courier, monospace;
}
.Code_Header_2 {
				font-size: x-large;
				font-weight: bold;
				text-align: left;
				font-family: "Courier New", Courier, monospace;
}
.Code_Header_3 {
				font-size: large;
				font-weight: bold;
				text-align: left;
				font-family: "Courier New", Courier, monospace;
}
.indent {
				margin-left: 40px;
}
.ctr_thinbord {
				text-align: center;
				border: 1px solid #000000;
}
.style4 {
				border-width: 0px;
				margin-left: 40px;
}
.style5 {
				margin-left: 80px;
				font-family: "Courier New", Courier, monospace;
				font-size: small;
}
</style>
</head>

<body>

<table style="width: 100%; line-height: 100%;">
				<tr>
								<td style="width: 484px">
<img alt="" src="ocdlogo.jpg"/></td>
								<td>
								<p>OCD is a set of Open Color format Definitions.</p>
<p>Color formats are used in everything from BLTers to video codecs, and from cameras to displays.&nbsp; But although 
there are plenty of common formats, the definition of the code specifying them is never the same. </p>
								<p>OCD attempts to solve this problem.&nbsp; It provides logical color format codes, and 
								is extensible.</p>
<hr />
												<table style="width: 100%">
																<tr>
																				<td>
<div class="download"><img alt="CC BY-ND" longdesc="Creative Commons Attribution-NoDerivs 3.0 Unported License" src="http://i.creativecommons.org/l/by-nd/3.0/88x31.png" width="88" height="31" /></div>
<p class="Header2">License</p>
																</td>
																</tr>
																<tr>
																				<td>
<div>
<p class="style17">The definitions are designed and maintained by Texas Instruments, Inc., but anyone is free to use them with no 
cost or obligation.</p>
<p>This project is licensed under the <a href="http://creativecommons.org/licenses/by-nd/3.0/">Creative Commons 
Attribution-NoDerivs 3.0 Unported License</a>.</p>
</div>
																				</td>
																</tr>
												</table>
<hr />
    							<table style="width: 100%">
												<tr>
																<td>
    <p class="Header2">Source</p>
    															</td>
												</tr>
												<tr>
																<td>
    <div class="download">
      <a href="http://github.com/graphics/ocd/zipball/master">
        <img width="90" alt="download zip" src="http://github.com/images/modules/download/zip.png" border="0"/></a>
      <a href="http://github.com/graphics/ocd/tarball/master">
        <img width="90" alt ="download tar" src="http://github.com/images/modules/download/tar.png" border="0"/></a>
    </div>
<div>
      Get the source code on GitHub at <a href="http://github.com/graphics/ocd">graphics/ocd</a>, or download this 
		project in either
      <a href="http://github.com/graphics/ocd/zipball/master">zip</a> or
      <a href="http://github.com/graphics/ocd/tarball/master">tar</a> formats.</div>
    <p>You can also clone the project with <a href="http://git-scm.com">Git</a> by running:</p>
      <pre><a class="cmd_line">$ git clone git://github.com/graphics/ocd</a></pre>
																</td>
												</tr>
												<tr><td><hr />
																<table style="width: 100%">
																				<tr>
																								<td class="Header2">Wiki</td>
																				</tr>
																				<tr>
																								<td><a href="https://github.com/graphics/ocd/wiki">https://github.com/graphics/ocd/wiki</a></td>
																				</tr>
																</table>
																</td></tr>
								</table>
								</td>
				</tr>
</table>
<hr />
<p class="Header1">Header File</p>
<p><span class="filename">ocd.h</span> contains the Open Color format Definitions.</p>
<p class="Header1">How does it work?</p>
<p>OCD was designed to allow a single 32-bit word (int) to specify the 
color format.&nbsp; The color format is specified as an enumeration.&nbsp; The 
enumeration values are constructed using bitfields.</p>
<p>OCD breaks off a chunk of those 32 bits to specify a vendor ID.&nbsp; With 
this, OCD can allow vendors with very unique formats to obtain their own vendor 
ID and specify any of 16 million formats of their own.&nbsp; Minimum sharing 
here, but maximum flexibility.</p>
<p class="Code_Header_2">OCDFMTDEF_VENDOR_ALL</p>
<p>The power of OCD lies in the shared vendor ID.&nbsp; The 
<span class="inline_code">OCDFMTDEF_VENDOR_ALL</span> vendor ID indicates that the common set of definitions is 
being used.&nbsp; And this set of definitions is designed to specify pretty much 
any reasonably common color format in use today.</p>
<p>When <span class="inline_code">OCDFMTDEF_VENDOR_ALL</span> is chosen, the remaining 24 bits of the format are 
sub-divided into bitfields used to describe the format.</p>
<p class="Header2">Predefined Names</p>
<p>A set of enumeration values are already provided with predefined names.&nbsp; 
It is easiest for clients to use these predefined values.&nbsp; They already cover most of 
the formats likely to be encountered.</p>
<p class="note">NOTE:&nbsp; The naming conventions of the predefined formats are based on their byte 
ordering, so they are not endian-dependent.&nbsp; The exceptions are the 16-bit 
packed formats, which are little-endian.</p>
<p>Some examples:</p>
<p class="indent"><span class="inline_code">OCDFMT_RGB24</span> is a format 
where each pixel consists of 3 bytes (24 bits).&nbsp; The first byte in memory 
(at address A, read as a byte) is the red component.&nbsp; The second byte in 
memory (at address A+1, read as a byte) is the green component.&nbsp; The third 
byte in memory (at address A+2, read as a byte) is the blue component.</p>
<p class="indent">OCDFMT_xRGB24 is a format where each pixel consists of 4 bytes 
(32 bits), but only 3 of these (24 bits) contain color information.&nbsp; The 
remaining 8 bits are ignored on a read, or filled with 0s on a write.</p>
<p>If the format of interest is not already specified, it is still likely that 
the format is supported by the VENDOR_ALL design.&nbsp; Using the bitfields below, new combinations can be constructed.&nbsp; These 
combinations are already legal, but they just have not been given names.&nbsp; 
Users of OCD can define their own names in a separate header file and include it 
using the OCD_EXTERNAL_INCLUDE mechanism:</p>
<p class="indent">file: <span class="filename">myocdfmts.h</span></p>
<p class="style5">MYOCDFMT_ALPHAMONO8 = OCDFMT_MONO8 |<br />
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 
OCDFMTDEF_ALPHA,</p>
<p class="indent">file:&nbsp; <span class="filename">mysource.c</span></p>
<p class="style5">#define OCD_EXTERNAL_INCLUDE &quot;myocdfmts.h&quot;<br />
#include &lt;ocd.h&gt;</p>
<p class="Header2">VENDOR_ALL Bitfields</p>
<p>The following bitfields only apply to the <span class="inline_code">
OCDFMTDEF_VENDOR_ALL</span> color formats. </p>
<p class="Header3">Color Space</p>
<p>The first field specifies the color space.&nbsp; Currently there are five 
color spaces defined, but there is room for three more if the need arises:</p>
<ul>
				<li>Monochrome - <span class="inline_code">OCDFMTDEF_CS_MONO</span></li>
				<li>Look-Up Table - <span class="inline_code">OCDFMTDEF_CS_LUT</span></li>
				<li>RGB -<span class="inline_code"> OCDFMTDEF_CS_RGB</span></li>
				<li>YCbCr (a.k.a. YUV) - <span class="inline_code">
				OCDFMTDEF_CS_YCbCr</span></li>
				<li>Alpha - <span class="inline_code">OCDFMTDEF_CS_ALPHA</span></li>
</ul>
<p>Once the color space has been selected, the remaining bits depend on that 
choice:</p>
<p class="Code_Header_3">OCDFMTDEF_CS_MONO</p>
<table class="style4">
				<tr>
								<td class="ctr_thinbord">31:24</td>
								<td class="ctr_thinbord">23:21</td>
								<td class="ctr_thinbord">20:19</td>
								<td class="ctr_thinbord">18</td>
								<td class="ctr_thinbord">17</td>
								<td class="ctr_thinbord">16</td>
								<td class="ctr_thinbord">15:14</td>
								<td class="ctr_thinbord">13:11</td>
								<td class="ctr_thinbord">10</td>
								<td class="ctr_thinbord">9</td>
								<td class="ctr_thinbord">8:6</td>
								<td class="ctr_thinbord">5:0</td>
				</tr>
				<tr>
								<td class="ctr_thinbord">00000000</td>
								<td class="ctr_thinbord">000</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">alpha</td>
								<td class="ctr_thinbord">non-premult/<br />
								fill empty 0</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reversed</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">container<br />
								size</td>
								<td class="ctr_thinbord">color<br />
								bits-1</td>
				</tr>
</table>
<p class="Code_Header_3">OCDFMTDEF_CS_LUT</p>
<table class="style4">
				<tr>
								<td class="ctr_thinbord">31:24</td>
								<td class="ctr_thinbord">23:21</td>
								<td class="ctr_thinbord">20:19</td>
								<td class="ctr_thinbord">18</td>
								<td class="ctr_thinbord">17</td>
								<td class="ctr_thinbord">16</td>
								<td class="ctr_thinbord">15:14</td>
								<td class="ctr_thinbord">13:11</td>
								<td class="ctr_thinbord">10</td>
								<td class="ctr_thinbord">9</td>
								<td class="ctr_thinbord">8:6</td>
								<td class="ctr_thinbord">5:0</td>
				</tr>
				<tr>
								<td class="ctr_thinbord">00000000</td>
								<td class="ctr_thinbord">001</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reversed</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">container<br />
								size</td>
								<td class="ctr_thinbord">color<br />
								bits-1</td>
				</tr>
</table>
<p class="Code_Header_3">OCDFMTDEF_CS_RGB</p>
<table class="style4">
				<tr>
								<td class="ctr_thinbord">31:24</td>
								<td class="ctr_thinbord">23:21</td>
								<td class="ctr_thinbord">20:19</td>
								<td class="ctr_thinbord">18</td>
								<td class="ctr_thinbord">17</td>
								<td class="ctr_thinbord">16</td>
								<td class="ctr_thinbord">15:14</td>
								<td class="ctr_thinbord">13:11</td>
								<td class="ctr_thinbord">10</td>
								<td class="ctr_thinbord">9</td>
								<td class="ctr_thinbord">8:6</td>
								<td class="ctr_thinbord">5:0</td>
				</tr>
				<tr>
								<td class="ctr_thinbord">00000000</td>
								<td class="ctr_thinbord">010</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">alpha</td>
								<td class="ctr_thinbord">non-premult/<br />
								fill empty 0</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">layout</td>
								<td class="ctr_thinbord">reversed</td>
								<td class="ctr_thinbord">left<br />
								justified</td>
								<td class="ctr_thinbord">container<br />
								size</td>
								<td class="ctr_thinbord">color<br />
								bits-1</td>
				</tr>
</table>
<p class="Code_Header_3">OCDFMTDEF_CS_YCbCr</p>
<table class="style4">
				<tr>
								<td class="ctr_thinbord">31:24</td>
								<td class="ctr_thinbord">23:21</td>
								<td class="ctr_thinbord">20:19</td>
								<td class="ctr_thinbord">18</td>
								<td class="ctr_thinbord">17</td>
								<td class="ctr_thinbord">16</td>
								<td class="ctr_thinbord">15:14</td>
								<td class="ctr_thinbord">13:11</td>
								<td class="ctr_thinbord">10</td>
								<td class="ctr_thinbord">9</td>
								<td class="ctr_thinbord">8:6</td>
								<td class="ctr_thinbord">5:0</td>
				</tr>
				<tr>
								<td class="ctr_thinbord">00000000</td>
								<td class="ctr_thinbord">011</td>
								<td class="ctr_thinbord">standard</td>
								<td class="ctr_thinbord">alpha</td>
								<td class="ctr_thinbord">non-premult/<br />
								fill empty 0</td>
								<td class="ctr_thinbord">subsample<br />
								position</td>
								<td class="ctr_thinbord">subsampling</td>
								<td class="ctr_thinbord">layout</td>
								<td class="ctr_thinbord">reversed</td>
								<td class="ctr_thinbord">left<br />
								justified</td>
								<td class="ctr_thinbord">container<br />
								size</td>
								<td class="ctr_thinbord">color<br />
								bits-1</td>
				</tr>
</table>
<p class="Code_Header_3">OCDFMTDEF_CS_ALPHA</p>
<table class="style4">
				<tr>
								<td class="ctr_thinbord">31:24</td>
								<td class="ctr_thinbord">23:21</td>
								<td class="ctr_thinbord">20:19</td>
								<td class="ctr_thinbord">18</td>
								<td class="ctr_thinbord">17</td>
								<td class="ctr_thinbord">16</td>
								<td class="ctr_thinbord">15:14</td>
								<td class="ctr_thinbord">13:11</td>
								<td class="ctr_thinbord">10</td>
								<td class="ctr_thinbord">9</td>
								<td class="ctr_thinbord">8:6</td>
								<td class="ctr_thinbord">5:0</td>
				</tr>
				<tr>
								<td class="ctr_thinbord">00000000</td>
								<td class="ctr_thinbord">100</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">reserved<br />
								(00)</td>
								<td class="ctr_thinbord">reversed</td>
								<td class="ctr_thinbord">reserved<br />
								(0)</td>
								<td class="ctr_thinbord">container<br />
								size</td>
								<td class="ctr_thinbord">alpha<br />
								bits-1</td>
				</tr>
</table>
<p>&nbsp;</p>
<p class="Header3">Standard (YCbCr)</p>
<p>This field specifies the standard being used for this color space.</p>
<p>Currently, this field is only defined for the YCbCr color space:</p>
<ul>
				<li><a href="http://www.itu.int/rec/R-REC-BT.601/en">ITU-R BT.601</a> - <span class="inline_code">
				OCDFMTDEF_STD_ITUR_601_YCbCr</span></li>
				<li><a href="http://www.itu.int/rec/R-REC-BT.709/en">ITU-R BT.709</a> - <span class="inline_code">
				OCDFMTDEF_STD_ITUR_709_YCbCr</span></li>
				<li><a href="http://www.w3.org/Graphics/JPEG/jfif3.pdf">Full Scale</a> - <span class="inline_code">
				OCDFMTDEF_FULLSCALE_YCbCr</span></li>
</ul>
<p>We believe that this field will be used to add linear format support in the 
very near future.</p>
<p class="Header3">Fill Empty 0 (Mono, RGB, YCbCr)</p>
<p>When there is no alpha included with a format, but the color components don&#39;t 
fill up the container, the remainder of the bits must be filled with something 
when written.&nbsp; When the <span class="inline_code">OCDFMTDEF_FILL_EMPTY_0</span> 
flag is not set, they are filled with 1.&nbsp; This is done in case they are 
later used as an alpha value, which will already represent an opaque pixel 
(whether the pixel is premultiplied or not).&nbsp; When the flag is set, they are 
filled with 0, to accommodate those environments where they are required to be 
cleared when unused.</p>
<p class="Header3">Alpha (Mono, RGB, YCbCr)</p>
<p>The <span class="inline_code">OCDFMTDEF_ALPHA</span> bit indicates that the 
format includes an alpha channel along with the main color components.</p>
<p class="Header3">Non-Premult (Mono, RGB, YCbCr)</p>
<p>Formats with alpha can have their color components pre-multiplied by the 
alpha component or not.&nbsp; When the <span class="inline_code">
OCDFMTDEF_NON_PREMULT</span> bit is set, the color components are not 
premultiplied by the accompanying alpha.&nbsp; When the bit is not set, the 
color components are already multiplied by the alpha.</p>
<p class="Header3">Subsampling (YCbCr)</p>
<p>Some formats can be subsampled.&nbsp; At this point, only subsampled YCbCr is 
supported.</p>
<ul>
				<li>No subsampling - <span class="inline_code">
				OCDFMTDEF_SUBSAMPLE_NONE</span></li>
				<li>4:2:2 subsampling - <span class="inline_code">
				OCDFMTDEF_SUBSAMPLE_422_YCbCr</span></li>
				<li>4:2:0 subsampling - <span class="inline_code">
				OCDFMTDEF_SUBSAMPLE_420_YCbCr</span></li>
				<li>4:1:1 subsampling - <span class="inline_code">
				OCDFMTDEF_SUBSAMPLE_411_YCbCr</span></li>
</ul>
<p class="Header3">Subsample Position (YCbCr)</p>
<p>Subsampling can have different equivalent positions relative to the pixels.&nbsp; 
Vertical subsampling positions are consistent, so the following are supported to 
control the horizontal subsampling position:</p>
<ul>
				<li><span class="inline_code">OCDFMTDEF_SUBSAMPLE_HORZ_ALIGNED 				</span>- subsamples are aligned with first pixel (e.g. MPEG-2 
				spec)</li>
				<li><span class="inline_code">OCDFMTDEF_SUBSAMPLE_HORZ_CENTERED
				</span>- subsamples are centered between the pixels (e.g. MPEG-1 
				spec)</li>
</ul>
<p>NOTE:&nbsp; It is encouraged that users of OCD be generous when handling 
subsampling positions.&nbsp; Allowing misaligned subsampling is preferable to 
complete failure.</p>
<p class="Header3">Alpha Components (Alpha)</p>
<p>To support applying alpha values to the individual components of other color 
spaces, the alpha color space can have more than one alpha value per pixel.&nbsp; 
This field specifies how many:</p>
<ul>
				<li><span class="inline_code">OCDFMTDEF_ALPHA_COMPONENTS_1 				</span>- pixel contains 1 alpha value (default)</li>
				<li><span class="inline_code">OCDFMTDEF_ALPHA_COMPONENTS_2
				</span>- pixel contains 2 alpha values</li>
				<li><span class="inline_code">OCDFMTDEF_ALPHA_COMPONENTS_3
				</span>- pixel contains 3 alpha values; suitable for RGB 
				manipulation (e.g. FreeType/ClearType)</li>
				<li><span class="inline_code">OCDFMTDEF_ALPHA_COMPONENTS_4
				</span>-- pixel contains 4 alpha values</li>
</ul>
<p class="Header3">Layout (RGB, YCbCr)</p>
<p>The layout values, in conjunction with the reversed and left-justified 
modifiers, specify how the pixel components are placed into memory.&nbsp; All 
non-RGB/YCbCr formats are packed.</p>
<ul>
				<li><span class="inline_code">OCDFMTDEF_PACKED </span>- pixel 
				components are sequential in memory, defaulting to RGB or CbCr 
				order, right justified</li>
				<li><span class="inline_code">OCDFMTDEF_DISTRIBUTED </span>- 
				pixel components that don&#39;t fill the container are evenly 
				distributed within the container (e.g. 32 bits of ARGB in a 
				64-bit container is distributed 8 bits every 16 bits: xAxRxGxB)</li>
				<li><span class="inline_code">OCDFMTDEF_2_PLANE_YCbCr </span>- 
				for subsampled formats only, Y plane is followed by subsampled 
				interleaved CbCr plane</li>
				<li><span class="inline_code">OCDFMTDEF_3_PLANE_STACKED </span>- 
				pixel components are divided into planes that are sequential in 
				memory</li>
				<li><span class="inline_code">
				OCDFMTDEF_3_PLANE_SIDE_BY_SIDE_YCbCr </span>- for subsampled 
				formats only pixel components are divided into planes, with the 
				non-subsampled component followed by the subsampled components 
				stored side-by-side (lines interleaved) </li>
</ul>
<p class="Header3">Reversed (RGB, YCbCr)</p>
<p><span class="inline_code">OCDFMTDEF_REVERSED</span> indicates that the order 
of the color components is the opposite of the defaults.&nbsp; For RGB formats, 
this means BGR.&nbsp; For YCbCr formats, this means CrCb.</p>
<p class="Header3">Left-Justified (RGB, YCbCr)</p>
<p><span class="inline_code">OCDFMTDEF_LEFT_JUSTIFIED</span> indicates that the 
color components are shifted to the left, as opposed to the default of shifting 
to the right.</p>
<p>Some examples for <span class="inline_code">OCDFMTDEF_REVERSED</span> and
<span class="inline_code">OCDFMTDEF_LEFT_JUSTIFIED</span>:</p>
<ul>
				<li>Packed RGB:&nbsp; x,R,G,B is the default byte order<ul>
								<li>x,B,G,R is the format if
								<span class="inline_code">OCDFMTDEF_REVERSED</span> 
								is set</li>
								<li>R,G,B,x is the format if
								<span class="inline_code">
								OCDFMTDEF_LEFT_JUSTIFIED</span> is set</li>
								<li>B,G,R,x is the format if
								<span class="inline_code">OCDFMTDEF_REVERSED</span> 
								and <span class="inline_code">
								OCDFMTDEF_LEFT_JUSTIFIED</span> are set</li>
				</ul>
				</li>
				<li>Packed YCbCr 4:2:2:&nbsp; U,Y,V,Y is the default byte order<ul>
								<li>V,Y,U,Y is the format if
								<span class="inline_code">OCDFMTDEF_REVERSED</span> 
								is set</li>
								<li>Y,U,Y,V is the format if
								<span class="inline_code">
								OCDFMTDEF_LEFT_JUSTIFIED</span> is set</li>
								<li>Y,V,Y,U is the format if
								<span class="inline_code">OCDFMTDEF_REVERSED</span> 
								and <span class="inline_code">
								OCDFMTDEF_LEFT_JUSTIFIED</span> are set</li>
				</ul>
				</li>
				<li>3-Plane YCbCr 4:2:2 or 4:2:0:&nbsp; The default is the Y 
				plane, followed by the Cb plane and then the Cr plane.&nbsp; The 
				Cb and Cr planes have half of the stride of the Y plane.<ul>
								<li>If <span class="inline_code">
								OCDFMTDEF_REVERSED</span> is set, the Cb and Cr 
								planes are reversed.</li>
								<li><span class="inline_code">
								OCDFMTDEF_LEFT_JUSTIFIED</span> has a special 
								case for this layout.&nbsp; When set, it 
								indicates that the Cb and Cr planes have the 
								same stride as the Y plane, and the Cb and Cr 
								data is shifted to the left.</li>
								<li>If both <span class="inline_code">
								OCDFMTDEF_LEFT_REVERSED</span> and
								<span class="inline_code">
								OCDFMTDEF_LEFT_JUSTIFIED</span> are set, the Cb 
								and Cr planes are reversed and double width.</li>
				</ul>
				</li>
				<li>2-Plane YCbCr 4:2:2 or 4:2:0:&nbsp; The default is the Y 
				plane, followed by the CbCr interleaved plane, with the same 
				stride as the Y plane.<ul>
								<li><span class="inline_code">OCDFMTDEF_REVERSED</span> 
								swaps the Cb and Cr components.</li>
				</ul>
				</li>
</ul>
<p class="Header3">Container (All)</p>
<p>The container field indicates the total size of all the bits of the color 
components of a color format.&nbsp; This does not include the alpha component, 
if it is present.</p>
<ul>
				<li><span class="inline_code">OCDFMTDEF_CONTAINER_8BIT</span> - 
				Indicates the container is 8 bits.&nbsp; When the pixel 
				component size is 4 bits or less, multiple pixels are stored in 
				the container.</li>
				<li><span class="inline_code">OCDFMTDEF_CONTAINER_16BIT</span> - 
				Indicates the container is 16 bits.&nbsp; When the pixel 
				component size is less than 16 bits, the remaining bits are 
				available to be used as an alpha channel.</li>
				<li><span class="inline_code">OCDFMTDEF_CONTAINER_24BIT</span> - 
				Indicates the container is 24 bits.&nbsp; When the pixel 
				component size is less than 24 bits, the remaining bits are 
				available to be used as an alpha channel.</li>
				<li><span class="inline_code">OCDFMTDEF_CONTAINER_32BIT</span> - 
				Indicates the container is 32 bits.&nbsp; When the pixel 
				component size is less than 32 bits, the remaining bits are 
				available to be used as an alpha channel.</li>
				<li><span class="inline_code">OCDFMTDEF_CONTAINER_48BIT</span> - 
				Indicates the container is 48 bits.&nbsp; When the pixel 
				component size is less than 48 bits, the remaining bits are 
				available to be used as an alpha channel.</li>
				<li><span class="inline_code">OCDFMTDEF_CONTAINER_64BIT</span> - 
				Indicates the container is 64 bits.&nbsp; When the pixel 
				component size is less than 64 bits, the remaining bits are 
				available to be used as an alpha channel.</li>
</ul>
<p class="Header3">Component Size (All)</p>
<p>The component size field specifies the total number of bits in the color 
components, not including the alpha component.&nbsp; (It is specified in the 
code with one subtracted.)</p>
<p class="note">NOTE:&nbsp; The alpha only color space uses this to specify the total number 
of alpha bits.</p>
</body>

</html>
